STRING

Section: Misc. Reference Manual Pages (3C++)
Updated: C++ String Library
Index Return to Main Contents
 

NAME

String - a dynamic String class library for C++.  

SYNOPSIS


# include <String.h>
   ...
   ...
 

Constructors

String()
String(StringRange n)
String(char ch)
String(const char *s)
String(const char *s,int n)
String(const String &s)
 

DESCRIPTION

Constructors are used to declare a String variable. Memory is allocated at this time and rounded up to the closest multiple of String::hunksize. A NULL is placed at the end of the String and the length is calculated (not including the NULL).
String()
Used to declare a String of length 0, or an array of Strings.
String(StringRange n)
Used to declare a String with pre-allocated space. The length of the String is still 0, it will have at least 'n' bytes allocated for it.
String(char ch)
Used to declare a String initialized to a character.
String(const char *s)
Used to declare a String initialized to a NULL terminated string.
String(const char *s ,int n)
Used to declare a String initialized to a character string of length n.
String(const String &s)
Used to declare a String initialized to another String.
 

OPERATOR =

String &operator = (char ch)
String &operator = (const char *s)
String &operator = (const String &s)
 

DESCRIPTION

Assignment copies the value of the right hand of the assignment operator into the String. If there is not enough space for the new String then the memory allocated for the String will be increased. The String is then NULL terminated and the new length set. Finally, reference to the String is returned.  

OPERATORS <, <=, ==, !=, >, >=

int operator OP (char)
int operator OP (const char *)
int operator OP (const String &)
int operator OP (char, const String &)
int operator OP (const char *, const String &s)
 

DESCRIPTION

The relational operators return a non-zero value if the relation holds true, and return zero if the relation is false. In the above list of functions, OP is one of the six relational operators: <, <=, ==, !=, >, or >=.  

OPERATOR +=

String &operator += (char ch)
String &operator += (const char *s)
String &operator += (const String &s)
 

DESCRIPTION

The += operator appends the given value to the String. The String will grow to fit the value if needed.  

OPERATOR -=

String &operator -= (int n)
String &operator -= (char ch)
String &operator -= (const char *s)
String &operator -= (const String &s)
String &operator -= (const StringSearch &ss)
 

DESCRIPTION

The -= operator removes the value from the end of the String. If the value is not at the end of the String the String is left unchanged.  

NOTES

String &operator -= (int n)
Substracts 'n' characters from the end of String. If 'n' is invalid then the String is left unchanged.
String &operator -= (const StringSearch &ss);
Removes the given pattern if it is at the end of String. The longest matching pattern is removed. If the pattern is not at the end the String then it is left unchanged.
 

OPERATOR *=

String &operator *= (int n)
 

DESCRIPTION

The *= operator multiplies the String 'n' times. If n is 0 then the String is set equal to "". If n is 1 the String is unchanged.  

OPERATOR /=

String &operator /= (char ch)
String &operator /= (const char *s)
String &operator /= (const String &s)
String &operator /= (const StringSearch &ss)
 

DESCRIPTION

The /= operator removes all occurrences of the value from the String. If the value to be removed is not in the String, the String is left unchanged.
 

OPERATOR +

String operator + (char ch) const
String operator + (const char *s) const
String operator + (const String &s) const
friend String operator + (char ch, const String &s)
friend String operator + (const char *s, const String &s)
 

DESCRIPTION

The + operator returns a new String which is the concatenation of two values. The original values are changed.  

OPERATOR -

String operator - (int n) const
String operator - (char ch) const
String operator - (const char *s) const
String operator - (const String &s) const
String operator - (const StringSearch &ss) const
 

DESCRIPTION

The - operator returns a new String which is equal to the String with the given value removed from the end of the String. If the value is not at end the of the String a copy of the String is returned.  

NOTES

String operator - (int n) const
Substracts 'n' characters from the end of String.
String operator - (const StringSearch &ss) const
Removes the given pattern if it is at the end of String. The longest matching pattern is removed.
 

OPERATOR *

String operator *(const String &s, int n)
String operator *(int n,const String &s)
 

DESCRIPTION

The * operator multiplies a String 'n' times and returns the new String. If n is 0 then "" is returned, and if n is 1 then a copy of the orignal String is returned.  

OPERATOR /

String operator / (char ch) const
String operator / (const char *s) const
String operator / (const String &s) const
String operator / (const StringSearch &ss) const
 

DESCRIPTION

The / operator returns a new String which is equal to the String with all occurrences of the value removed from the String. If the value to be removed is not in the String, then a copy of the String is returned.  

OPERATOR []

char operator[](int i)
 

DESCRIPTION

The [] operator returns the character in String indexed by 'i'. If the index 'i' is out of range ( i < 0 || i > length) then a fatal String exception will occur and the program will terminate.  

NOTES

The [] operator returns a 'char' and not a 'char&'. This means in order to change a character at index 'i' you must use the substr(i,1) function. This is to simpify the update() function.  

FUNCTION substr

SubString substr(int p)
SubString substr(int p, int n)
 

DESCRIPTION

The substr function returns the SubString at position 'p', with length If either 'p' or 'n' are invalid, the NullString is returned.  

NOTES

SubStrings can be assiged to. What gets changed is the actual String that the SubString is part of.

As mentioned above, if an invalid position or length is passed to substr, the NullString ("") is returned. This String cannot be assigned to or changed.

For a String of length n, the following are valid SubStrings:

s.substr(0,0) - the String "" at the front of the String
s.substr(n,0) - the String "" at the end of the String

All other functions that return SubStrings use this function to do so.  

OPERATOR ()

SubString operator () (int pos)
SubString operator () (int pos, int n)
SubString operator () (char c)
SubString operator () (const char *s)
SubString operator () (const String &s)
SubString operator () (const StringSearch &ss)
 

DESCRIPTION

The () operator returns the SubString at the given position. If the position is invalid or the value dos not exist, the NullString is returned.  

NOTES

SubString operator () (int pos)
Return the SubString from the given position to the end of the String.
 

OPERATOR const char *

operator const char *() const
 

DESCRIPTION

The const char * operator is to allow a String to be used where ever a const char * is.  

FUNCTION cptr

char *cptr() const
 

DESCRIPTION

The cptr function returns a char pointer, which is pointer to the actual String data. Note that this function can be VERY dangerous, as it bypasses all the interal checks. It should only be used in extreme cases where there is no way to do it within the String class. If you do change the length of the String with cptr, you should use the set_length function. If you don't change the length, but do change the value, you should call the update function.  

FUNCTION icase, ucase, set_case, get_case

enum CaseCompare { IgnoreCase=0,UseCase=1};
static CaseCompare get_case()
static void set_case(CaseCompare c)

String &icase()
String &ucase()
 

DESCRIPTION

The set_case and get_case are used to set the case compare flag for the whole String class. If the case compare flag is set to IgnoreCase, then case will be ignored during all comparisons. The default is UseCase. The icase and ucase functions are temporary and affect the next comparison only.  

EXAMPLES


    // String s1("hello");
    if (s1.icase() == "HELLO") ... // this would be true  
    // String s2("Hello World");
    s2.icase().at("WORLD") = "There World!";
    // s2 == "Hello There World!"  

OPERATOR ostream << String

ostream &operator<<(ostream &os, const String &s)
 

DESCRIPTION

The << operator is used to output a String to a ostream. No formating is done, the String is simply placed in the ostream.  

NOTES

Currently, the << operator ignores settings in the iostream class, like field width's and padding. Simply use the other String functions: substr, pad,trunc, to format the String.

Example: cout << s1(0,10) << endl;  

OPERATOR istream >> String

friend istream &operator>>(istream &is, String &s)
 

DESCRIPTION

The >> operator is used to input a String from an istream. Whitespace is skipped, and the longest non-whitespace field encountered is placed in the String. Note that since Strings are dynamic, there is no need to specify a maximum buffer size.  

NOTES

As with the << operator, the >> opertor currently does not look at any of the iostream's internal format variables. This might change in a future release.  

FUNCTION getline

friend int getline(istream &is,String &s,char delim=',int dropit=1)
 

DESCRIPTION

The getline function is used to input a line from an istream into a String. This function does not skip whitespace. Everything up to the delimiter is included in the String. If the dropit value is 0, then the delimiter is also included.  

FUNCTION empty

int empty()
 

DESCRIPTION

The empty function returns TRUE (non-zero) if the length of the String is 0.  

OPERATOR !

int operator !()
 

DESCRIPTION

The ! operator returns TRUE (non-zero) if the length of the String is 0. It is equivalent to the emtpy function.  

OPERATOR void *

operator void *() const
 

DESCRIPTION

The void * operator returns the length of the String. The returned value is not meant to be used as a pointer, but as a test in a condition.
// String s1;
if (s1) ... // the if will be true if s1.length() > 0  

FUNCTION length

StringRange length() const
 

DESCRIPTION

The length function returns the length of the String. This does not include the NULL which is maintained internally at the end of String.  

FUNCTION set_length

StringRange set_length(StringRange new_len)
 

DESCRIPTION

The set_length function sets the current length of the String. If the new_length is longer then the currently allocated size of the String, the String is unchanged. To allocate more space, use the pad function. If the String's length is changed, the update function is called.  

FUNCTION size

StringRange size() const
 

DESCRIPTION

The size function returns the amount of memory currently allocated for the String, including the NULL at the end.  

FUNCTION index

int index(char ch) const
int index(const char *s) const
int index(const String &s) const
int index(const StringSearch &ss) const
 

DESCRIPTION

The index function returns the position of the first occurrence of the value within the String, or -1 if the value is not in the String.  

FUNCTION contains

int contains(char ch) const
int contains(const char *s) const
int contains(const String &s) const
int contains(const StringSearch &ss) const
 

DESCRIPTION

The contains function returns TRUE (non-0) if the String contains the given value, and 0 if it does not.

 

FUNCTIONS left, right, between

SubString left(int n);

SubString right(int n);

SubString between(int p1,int p2);
 

DESCRIPTION

The left function returns the leftmost 'n' characters in the String. The right function returns the rightmost 'n' characters in the String. The between function returns the character between (including) the two positions.  

NOTES

Like substr, if an illegal value is specifed, the NullString is returned. The between function includes the characters at the positions. Since these functions return SubStrings, they can be on the left side of an expression.  

FUNCTION insert

String &insert(int pos,char c)
String &insert(int pos,const char *s)
String &insert(int pos,const String &s)
 

DESCRIPTION

The insert function inserts a given value into a String at position 'pos'. If the position 'pos' is invalid, the String is left unchanged.  

NOTES

Since this function returns a reference to the String, operations can be chained together: s1.insert(5,"xyz").substr(2,3)...etc  

FUNCTION prepend

String &prepend(char c)
String &prepend(const char *s)
String &prepend(const String &s)
 

DESCRIPTION

The prepend function prepends the given value to the front of the String.  

FUNCTION append

String &append(char c)
String &append(const char *s)
String &append(const String &s)
 

DESCRIPTION

The append function appends the given value to the end of the String.  

FUNCTION remove

String &remove(int pos, int n)
String &remove(char c)

String &remove(const char *)

String &remove(const String &s)
String &remove(const StringSearch &ss)
 

DESCRIPTION

The remove function removes the first occurence of the given value in the String. If the value does not exist, the String is left unchanged.  

FUNCTION before

SubString before(int pos)
SubString before(char c)
SubString before(const char *s)
SubString before(const String &s)
SubString before(const StringSearch &ss)
 

DESCRIPTION

The before function returns the SubString from the beginning of the String upto the given value. This does not include the value, but does include everything before the value. If the position is invalid or the given value does not exist, then the NullString is retuned.  

FUNCTION through

SubString through(int pos)
SubString through(char c)
SubString through(const char *s)
SubString through(const String &s)
SubString through(const StringSearch &ss)
 

DESCRIPTION

The through function returns the SubString from the beginning of the String through the given value. If the position is invalid or the given value does not exist, then the NullString is retuned.  

FUNCTION at

SubString at(int pos,int len=1)
SubString at(char c)
SubString at(const char *s)
SubString at(const String &s)
SubString at(const StringSearch &ss)
 

DESCRIPTION

The at function returns the SubString 'at' the given position/value. If the position is invalid or the given value does not exist, then the NullString is retuned. This function is equivalent to the () operator.  

FUNCTION from

SubString from(int pos)
SubString from(char c)
SubString from(const char *s)
SubString from(const String &s)
SubString from(const StringSearch &ss)
 

DESCRIPTION

The from function returns the SubString from the given value to the end of the String. If the position is invalid or the given value does not exist, then the NullString is retuned.  

FUNCTION after

SubString after(int pos)
SubString after(char c)
SubString after(const char *s)
SubString after(const String &s)
SubString after(const StringSearch &ss)
 

DESCRIPTION

The after function returns the SubString after the given value to the end of the String. If the position is invalid or the given value does not exist, then the NullString is retuned.  

FUNCTION except

String except(int pos,int n)
String except(char c)
String except(const char *s)
String except(const String &s)
String except(const StringSearch &ss)
 

DESCRIPTION

The except function returns a new String, which contains everything in the original string except the first occurence of the given value. If the position is invalid or the given value does not exist, the original String is returned.  

FUNCTION replace

String &replace(char c1, char c2)
String &replace(char c1, const char *s)
String &replace(char c1, const String &s)
String &replace(const char *s1, char c1)
String &replace(const char *s1, const char *s2)
String &replace(const char *s1, const String &s2)
String &replace(const String &s1, char c1)
String &replace(const String &s1, const char *s2)
String &replace(const String &s1, const String &s2)
String &replace(const StringSearch &ss, char c1)
String &replace(const StringSearch &ss, const char *s)
String &replace(const StringSearch &ss, const String &s)
String &replace(const StringSearch &ss, char c1, String &matched)
String &replace(const StringSearch &ss, const char *s, String &matched)
String &replace(const StringSearch &ss, const String &s, String &matched)
 

DESCRIPTION

The replace function replaces the given value with a new value. If the given value does not exist, the String is left unchanged.  

NOTES

String &replace(const StringSearch &ss, ... , String &matched)
The replace functions that replace a pattern have an optional third argument which was the String that was matched.
 

FUNCTION pos

SubString& pos(int &pos)
 

DESCRIPTION

The pos function places the position of the SubString within the String. Example: String s1("hello there"); s1.after(" ").pos(p); // p==6  

FUNCTION skip, ws

SubString skip(char c)
SubString skip(const char *s)
SubString skip(const String &s)
SubString skip(const StringSearch &ss)
SubString ws()
 

DESCRIPTION

The skip function skips the given value, and returns the SubString after the value. In this respect it is like the after function, execept in the case where the value doesn't exist, the after function will return the NullString, and the skip function will simply return the rest of the String. This is because the skip function is used to 'skip' over part of a String, and since you are skipping over it, it should not be an error to skip over a non-existant value.  

NOTES

SubString ws()
The ws() function is equivalent to skip(RXwhite). It is simply a convenience function. It effectivly 'eats' whitespace and returns whatever follows.
 

FUNCTION match

SubString match(char ch)
SubString match(char ch,int &pos)
SubString match(const char *s)
SubString match(const char *s,int &pos)
SubString match(String &s)
SubString match(String &s,int &pos)
SubString match(const StringSearch &ss)
SubString match(const StringSearch &ss,int &pos, int &n)
SubString match(const StringSearch &ss, String &matched)
SubString match(const StringSearch &ss, String &matched, int &pos, int &n)
 

DESCRIPTION

The match function tries to match the given value with the beginning of the String. In the case of StringSearch's, the longest match is used. If the a match is made, everything following the match is returned. If no match is found, the NullString is returned. The match function also takes an optional parameter which is a integer set to the postion within the String the given value was located at. If the value was not matched, then the position will be set to -1.  

FUNCTION moveto

SubString moveto(char ch)
SubString moveto(char ch,int &pos)
SubString moveto(const char *s)
SubString moveto(const char *s,int &pos)
SubString moveto(String &s)
SubString moveto(String &s,int &pos)
SubString moveto(const StringSearch &ss)
SubString moveto(const StringSearch &ss,int &pos, int &n)
SubString moveto(const StringSearch &ss, String &matched)
SubString moveto(const StringSearch &ss, String &matched, int &pos, int &n)
 

DESCRIPTION

The moveto function moves to the specified value, and returns the SubString from that value to the end of the String. In this respect it is like the from function. The moveto function also takes an optional parameter which is a integer value set to the position within the String the given value was located at, or -1 if the value was not found. If the given value does not exist the NullString is returned. One use of the moveto function is in conjection with the match function.  

EXAMPLES

String s1("set id=1234"),idstr; Regex RXid("id=[0-9]+");

s1.moveto("id=").match(RXid,idstr); // idstr=="id=1234"  

FUNCTION find

SubString find(char ch)
SubString find(char ch,int &pos)
SubString find(const char *s)
SubString find(const char *s,int &pos)
SubString find(const String &s)
SubString find(const String &s,int &pos)
SubString find(const StringSearch &ss)
SubString find(const StringSearch &ss,int &pos, int &n)
SubString find(const StringSearch &ss, String &matched)
SubString find(const StringSearch &ss, String &matched, int &pos, int &n)
 

DESCRIPTION

The find function finds the given value and returns the String after the value. In this respect it is like the after function. The find function also takes an optional parameter which is a integer value to set to the position within the String the given value was located at, or -1 if the value was not found. If the given value is not in the String, the NullString is returned. One use of the find function is in conjection with the match function.  

EXAMPLES

String s1("set id=1234"),id; Regex RXid("[0-9]+"); s1.find("id=").match(RXid,id); // id=="id=1234"  

FUNCTION split

int split(const StringSearch &ss, String result[], int n)
int split(String &s,const StringSearch &ss, String res[], int n)
 

DESCRIPTION

The split function splits the given String into at most 'n' Strings, and returns the number of Strings split. It spits the String using the pattern as the field seperator. For example:

// int n; String s1("a b c "); String words[10]
n=s1.split(RXwhite,words,10)

Would split the String s1 into 3 individual Strings, constisting of "a","b","c" (word[0],word[1],word[2]).

This function is equivalent to the awk split function.  

FUNCTION trim

enum Side { Left=1,Right=2,Both=3 }
String &trim(Side pt=String::Both)
String trim(const char *s,Side pt=String::Both)
String trim(const String &s,Side pt=String::Both)
 

DESCRIPTION

The trim function remove leading and/or trailing whitespace from the String. The non-member functions return a new String with the whitespace removed. The default is to remove leading and trailing whitespace.  

FUNCTION pad

enum Side { Left=1,Right=2,Both=3 }
String &pad(int n,Side pt=String::Right,char pc=' ')
String pad(const char *s,int n,Side pt=String::Right,char pc=' ')
String pad(const String &s,int n,Side pt=String::Right,char pc=' ')
 

DESCRIPTION

The pad function pads a String to length 'n', using the specified pad character. If the String is already longer then length 'n', it is left unchanged. The String can be padded on the left, right, or both sides. In the case of both sides, the String is padded on alternate sides ( starting with the left) to the desired length is obtained. The non-member functions return a new String. The default pad character is space, and the default pad side is the right.  

FUNCTION trunc

String &trunc(int n)
String trunc(const char *s, int n)
String trunc(const String &s, int n)
 

DESCRIPTION

The trunc function truncates the given String to length 'n'. If 'n' is greater then the current length of the String the String is left unchanged.  

FUNCTION upper, lower

String &upper()
String upper(const char *s)
String upper(const String &s)
String &lower()
String lower(const char *s)
String lower(const String &s)
 

DESCRIPTION

The upper and lower functions upper case and lower case a String. The non-member functions return a new String, while the member functions modify the original String.  

FUNCTION reverse

String &reverse()
String reverse(const char *s)
String reverse(const String &s)
 

DESCRIPTION

The reverse function reverses a String. The non-member functions return a new String, while the member functions modify the original String.  

FUNCTION update

virtual void update()
 

DESCRIPTION

The update function is called internally by any function that changes that value of the String. This function's main use is for classes publicly derived from String to have some control over a String's value when it is changed (updated). For example, the Regex class defines update to be the following inline function:


           void update() { changed=1; }

Since update is a virtual function, this version of update will be called whenever a Regex is modifed by a String function. For example:
     Regex RXab("[ab]*"); 
     String s1("aabababba");
     if (s1.contains(RXab)) ...   //  0 or more a's or b's
     RXab('*')='+';               // operator () will call update()
     if (s1.contains(RXab)) ...   //  1 or more a's or b's

This statement uses the String operator () to change the value of RXab. Since the () operator is changing the value, the virtual Regex::update function will be called and the changed flag will be set. Now, the next time the regular expression RXab is used, it will see that the changed flag has been set and the regular expression will be recompiled before it is used. If the update function did not exist, the Regex class would have to inherit the String class as private, or redefine every single function in the String class.  

NOTES

By default, the update function for a String is to do nothing, so no (or little) overhead is involved. This can be changed using the set_update function.  

FUNCTION set_update

typedef void (*UpdateFunc)(String *)
static void set_update(UpdateFunc f)
 

DESCRIPTION

The set_update function is used as a hook into the String::update function. By default the String::update function simply checks to see if a function has been set by set_update, if not it does nothing. The following is an example of a set_update use:


 void debug_update(String *s) {
      cout << " debug_update : " << (*s) << endl;
 }

main() {
  ...
  String::set_update(debug_update);
  ... Now, whenever a String's value is changed, the function debug_update will be called. Note the the update function is a function of type void that takes a pointer to the String being updated.  

NOTES

Since update is a virtual function, set_update will have no effect on classes derived from String that have their own update function. It will affect those derived classes that do not define their own update function.  

FUNCTION get_hunksize, set_hunksize

static StringShort get_hunksize()
static void set_hunksize(StringShort s)
 

DESCRIPTION

The get_hunksize and set_hunksize functions are used to get and set the String::hunk_size value. The hunk_size is the amount of memory that is allocated whenever a String's length is increased. For example, if the hunk_size is 8, then String s("abc") will allocate 8 bytes for the String. If we then did a s+="123456", the result would not fit in the orignal 8 bytes, so the size would be re-allocated to 16 bytes. By default String::hunk_size is set to 16 bytes.  

NOTES

Increasing hunk_size will reduce the amount of calls to new, which in turn will decrease the number of time the String will have to copied over to a the new location when its size out grows the memory allocate to it. The downside is the amount of internal fragmentation (wasted space) will increase for small Strings. Currently, Strings only grow in size, and do not shrink.  

FUNCTION dump, exception, VERIFY

void dump()
void exception(char *message)
void VERIFY()
 

DESCRIPTION

The dump command is used to dump out a String's internal structure. The total space alloated for the String, the String's length, and the actual String will be dumped to cerr.
The exception command will print an error message to cerr, and then call dump to dump the String's value.
The VERIFY function is used to VERIFY the String's internal data structure. It checks that the length is not greater then the size of the allocated memory, that the String is NULL terminated properly, and that the pointer to the allocated memory is not NULL.


 

Index

NAME
SYNOPSIS
Constructors
DESCRIPTION
OPERATOR =
DESCRIPTION
OPERATORS <, <=, ==, !=, >, >=
DESCRIPTION
OPERATOR +=
DESCRIPTION
OPERATOR -=
DESCRIPTION
NOTES
OPERATOR *=
DESCRIPTION
OPERATOR /=
DESCRIPTION
OPERATOR +
DESCRIPTION
OPERATOR -
DESCRIPTION
NOTES
OPERATOR *
DESCRIPTION
OPERATOR /
DESCRIPTION
OPERATOR []
DESCRIPTION
NOTES
FUNCTION substr
DESCRIPTION
NOTES
OPERATOR ()
DESCRIPTION
NOTES
OPERATOR const char *
DESCRIPTION
FUNCTION cptr
DESCRIPTION
FUNCTION icase, ucase, set_case, get_case
DESCRIPTION
EXAMPLES
OPERATOR ostream << String
DESCRIPTION
NOTES
OPERATOR istream >> String
DESCRIPTION
NOTES
FUNCTION getline
DESCRIPTION
FUNCTION empty
DESCRIPTION
OPERATOR !
DESCRIPTION
OPERATOR void *
DESCRIPTION
FUNCTION length
DESCRIPTION
FUNCTION set_length
DESCRIPTION
FUNCTION size
DESCRIPTION
FUNCTION index
DESCRIPTION
FUNCTION contains
DESCRIPTION
FUNCTIONS left, right, between
DESCRIPTION
NOTES
FUNCTION insert
DESCRIPTION
NOTES
FUNCTION prepend
DESCRIPTION
FUNCTION append
DESCRIPTION
FUNCTION remove
DESCRIPTION
FUNCTION before
DESCRIPTION
FUNCTION through
DESCRIPTION
FUNCTION at
DESCRIPTION
FUNCTION from
DESCRIPTION
FUNCTION after
DESCRIPTION
FUNCTION except
DESCRIPTION
FUNCTION replace
DESCRIPTION
NOTES
FUNCTION pos
DESCRIPTION
FUNCTION skip, ws
DESCRIPTION
NOTES
FUNCTION match
DESCRIPTION
FUNCTION moveto
DESCRIPTION
EXAMPLES
FUNCTION find
DESCRIPTION
EXAMPLES
FUNCTION split
DESCRIPTION
FUNCTION trim
DESCRIPTION
FUNCTION pad
DESCRIPTION
FUNCTION trunc
DESCRIPTION
FUNCTION upper, lower
DESCRIPTION
FUNCTION reverse
DESCRIPTION
FUNCTION update
DESCRIPTION
NOTES
FUNCTION set_update
DESCRIPTION
NOTES
FUNCTION get_hunksize, set_hunksize
DESCRIPTION
NOTES
FUNCTION dump, exception, VERIFY
DESCRIPTION

This document was created by man2html, using the manual pages.
Time: 00:37:36 GMT, March 30, 2022